home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr35 / rblook13.zip / RBLOOK.DOC < prev    next >
Text File  |  1993-05-08  |  9KB  |  227 lines
  1.  
  2.   RBLOOK v1.3 - Another Five Minute Production.
  3.   (c) 1993, ComPAT Computer Services.
  4.  
  5.  
  6.   RBLOOK was written for personal use on my Bulletin Board System.
  7.   It will help track telephone expenses on a 'per HUB' basis without
  8.   it being necessary to analyze the monthly bill in excruciating detail. 
  9.   With RBLOOK's output, you'll have a list to use to cross-check that 
  10.   monthly phone bill .. to verify the calls that are listed in a much
  11.   easier manner ... it should help out, anyway.
  12.  
  13.   Note that this program runs fine on my DTK 386/25 under DESQview,
  14.   AST Premium/286 and IBM 486/25 Model 90 machines .. I don't think there's
  15.   anything about this program that will cause you trouble .. if so, it's 
  16.   certainly NOT intentional ... given that, I'm sorry, but this has to 
  17.   happen, so we better get it over with ...
  18.  
  19.   ┌─────────────────────────────────────────────────────────────────────────┐
  20.   │ This is a FREE utility .... no charge, use it freely and of your own    │
  21.   │ volition ... I WILL NOT be held responsible for ANY data loss or        │
  22.   │ equipment damage that you may experience.  You've read enough of that   │
  23.   │ legalese stuff to know about the rest ...                               │
  24.   │           ... simply, if it breaks, it ain't _my_ problem!              │
  25.   └─────────────────────────────────────────────────────────────────────────┘
  26.   
  27.   [ Well, it took about twenty minutes, but big deal ;) ]
  28.  
  29.   RBLOOK reads your ROBOCOMM.LOG file and looks for all calls that
  30.   Robocomm lists as  " completed " to the 'system' (HUB) that you
  31.   specify on the command line.  More specifically, RBLOOK examines
  32.   each line of ROBOCOMM.LOG and looks for " 'DISCONNECTED FROM ' +
  33.   the 'SystemID' ".
  34.  
  35.   USAGE:
  36.  
  37.     RBLOOK hubname [logfile.ext]
  38.  
  39.     Where:  hubname     = the PACKET name of the system you're calling.
  40.             logfile.ext = Any ROBOCOMM.LOG which may have been renamed.
  41.  
  42.     [ to read a .LOG other than one named ROBOCOMM.LOG, include the
  43.       log file name on the command line.  IE - RBLOOK MUSTANG MAY.LOG ]
  44.  
  45.   For Example .....
  46.      
  47.   RBLOOK MUSTANG 
  48.  
  49.     ... would list all calls to the system identified as 'MUSTANG'.
  50.   The listing will be named [hubname].USE' (MUSTANG.USE in the above case)
  51.   and that output will resemble the following listing, which can be
  52.   interpretted thusly  [ MOST is obvious, but ...] ... 
  53.  
  54.    Each 'detail line' contains ...
  55.  
  56.      Date     Time    Elapsed    Min R C    Cost 
  57.    ──────── ────────  ────────  ─────────  ──────
  58.    04/30/93 04:28:55  00:01:49     2 N H    0.26
  59.    │        │         │            │ │ │    │
  60.    Date     Time      Duration     │ │ │    Estimated
  61.                      BILLable Time─┘ │ │    Cost
  62.                          * RATE used─┘ │
  63.                            ** Protocol─┘
  64.  
  65.     *  This is the RATE that was used to calculate the cost of the call.
  66.        The call's 'time of day' is used to derive the rate.  Rates
  67.        are either 'day time, evening or nite time' ( D, E or N ).
  68.  
  69.     ** The 'protocol' is the 'connection type' that was used to
  70.        recognize the 'fudge-factor' when incrementing the ELAPSED
  71.        time reported by Robocomm.  This is to allow a bit of
  72.        'overhead' accounted for by the modem's traneing sequence.
  73.        These will ve reported as:  H = HST, V = V32, U = V32BIS and
  74.        a " ? " for unidentified protocols.  (remember that I set this
  75.        program up for my use .. it reads the log correctly. in this
  76.        regard, for _my_ modem .. a USR HST DS w/v42bis .. to 'older'
  77.        model with the round LEDs.)
  78.                         
  79.   Anyway .. the sample ..
  80.   ----------------------------------------------
  81.   RBLOOK v1.31 - Another Five Minute Production.
  82.   
  83.           Phone usage for HUB: MUSTANG
  84.   
  85.     Date     Time    Elapsed    Min R C    Cost 
  86.   ──────── ────────  ────────  ─────────  ──────
  87.   04/05/93 18:27:41  00:02:10     3 E V    0.45
  88.   04/06/93 10:46:39  00:01:13     2 D U    0.50
  89.   04/07/93 04:22:20  00:00:55     1 N H    0.13
  90.    ...........................................
  91.   04/29/93 04:28:38  00:01:24     2 N H    0.26
  92.       "    18:48:51  00:01:33     2 E H    0.30
  93.   04/30/93 04:28:55  00:01:49     2 N H    0.26
  94.   ──────── ────────  ────────  ─────────  ──────
  95.   Calls counted: 28    Minutes:  59        8.41
  96.  
  97.    Average time/≈cost per call:   2.1      0.30
  98.  
  99.      MUSTANG.RAT: Rate file found and used.
  100.   
  101.                    Day - 0.25
  102.                Evening - 0.15
  103.                  Night - 0.13
  104.  
  105.        Total lines in ROBOCOMM.LOG: 6608
  106.   ----------------------------------------------
  107.  
  108.   Phone Rates.
  109.  
  110.     There are three 'kinds' of rates:  Daytime, Evening and Nighttime
  111.   (or Weekend) rates.
  112.  
  113.     The program uses default values of .25, .15 and .13 respectively.
  114.   The defaults MAY BE OVERRIDDEN by creating an ASCII file named
  115.   [hubname].RAT in the default directory.  This file should be three 
  116.   lines long, each line terminated by a carriage return/line feed.
  117.   Very simple file ... for example ...
  118.  
  119.   .22
  120.   .16
  121.   .11
  122.  
  123.   .... could be one.  The decimal point MUST be present to designate
  124.   'cents' and must be flush with the left margin [it is indented here
  125.   ONLY to stay in line with these modest docs].
  126.  
  127.  
  128.   Costs.
  129.  
  130.     Costs are computed as follows:
  131.  
  132.     The TIME OF DAY is considered to determine the RATE that is used.
  133.  
  134.      08:00am - 16:59pm = Daytime Rate
  135.      17:00pm - 22:59pm = Evening Rate
  136.      23:00pm - 07:59am = Nighttime Rate
  137.  
  138.     * No consideration is given to weekends!  Weekends generally mean
  139.       that NIGHTTIME rates are in effect, between 11:00pm Friday and
  140.       17:00pm Sunday.
  141.  
  142.     The ELAPSED TIME of the call is rounded to the next higher whole 
  143.     number to conform to Ma Bell's billing structure.  For example:  
  144.     A call who's duration is 2 minutes and 25 seconds will be calculated
  145.     (and billed) as though the call had lasted 3 minutes.
  146.  
  147.  
  148.     The appropriate rate (decided by examining the time of day of the
  149.     connection) is multiplied by the call's duration giving a cost for
  150.     that call.  This figure is also accumulated and reported at the end
  151.     of the report.
  152.  
  153.     ** A 'fudge factor' has been incorporated!  When ANY comm.
  154.        program (that includes Robocomm<g>) reports a CONNECTion,
  155.        the actual phone call has been underway for a while - while
  156.        the modems did their handshake.  Thusly, a default factor of
  157.        15 (fifteen) seconds is added to the call's duration.
  158.        NOTE: I have made the exception for HST connections (generally 
  159.        faster) to be 8 (eight) seconds.
  160.  
  161.        The 'fudge-factors' that RBLOOK uses are:
  162.  
  163.         Connection type/trigger string Seconds added
  164.         ────────────────────────────── ─────────────
  165.  
  166.                    HST / "HST/HST"           8
  167.                    V32 / "HST/V"            14
  168.                 V32BIS / "32BIS"            12
  169.  
  170.         If none of the above are located, 15 seconds is added
  171.         to the connect time.
  172.  
  173.  
  174.   Totals.
  175.  
  176.     Nothing fancy here ... the BILLED minutes and the total cost are
  177.     displayed, along with an average minutes per call and average
  178.     cost per call.
  179.  
  180.  
  181.  
  182.   ** A final note:  I wrote this program to suit _my_ needs.  I understand
  183.                     what the program does and what it does NOT do ... it's
  184.                     really pretty simple.  It was written to tabulate the 
  185.                     expense associated with pulling echo mail from a HUB 
  186.                     system (therefore the 'HUBName' and 'HUB' references:
  187.                     this is what Robocomm refers to as the 'System ID'.
  188.  
  189.   If you find this program of use, cool!  You can use it 'til the
  190.   cows come home BUT ...  I operate an electronic bulletin board system
  191.   named " Ginger's Port Limited ".  It's a somewhat expensive 'hobby' and
  192.   I'd REALLY appreciate you sending a few bucks in Ginger's direction.
  193.  
  194.   If you don't like that idea, that's cool, too ... I mean ... afterall,
  195.   do you think a helicopter will drop a paddy wagon full of software cops
  196.   on your doorstep? ;)
  197.  
  198.  
  199.   Take care and don't feed Ma Bell too much ...
  200.  
  201.  
  202.   Phill Terry  
  203.  
  204.  
  205.   PS - You may contact me through using one of the following ....
  206.  
  207.      - Intelec(tm)            :  Net Chat conference.
  208.      - MSI SupportNET         :  Off-Topic conference.
  209.      - USNetMail              :  US_E-Mail conference.
  210.      - CompuLink(tm)          :  ChitChat conference.
  211.      - RaceNet(tm)/UnitedNet  :  Chit Chat conference.
  212.      - CompuServe <sigh>      :  User ID 73427,1427
  213.  
  214.    OR ... you can call my board ...
  215.            
  216.                   ┌─────────────────────────────────────┐
  217.                   │      Ginger's Port Limited          │
  218.                   │         Columbus, Ohio              │
  219.                   │                                     │
  220.                   │    24 Hours / 2400-38400 bps        │
  221.                   │                                     │
  222.                   │ 614-268-9456 - USR HST DS (v32)     │
  223.                   │ 614-784-8555 - USR Sportster v32bis │
  224.                   │                                     │
  225.                   └─────────────────────────────────────┘
  226.  
  227.